MCDrawBadge(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Managing Controller Attributes

MCDrawBadge
The MCDrawBadge function allows you to display a controller's badge. This function places the badge in an appropriate location based on the location of the controller's movie.
pascal ComponentResult MCDrawBadge (MovieController mc,
                                    RgnHandle movieRgn, 
                                    RgnHandle *badgeRgn);
mc
Specifies the movie controller for the operation. You obtain this
identifier from the Component Manager's OpenComponent or OpenDefaultComponent function, or from the NewMovieController function (described on page 2-28).
movieRgn
Specifies the boundary region of the controller's movie.
badgeRgn
Points to a region that is to receive information about the location of the badge--your application must dispose of this handle. The movie controller returns the region where the badge is displayed. If you are not interested in this information, you may set this parameter to nil.

DESCRIPTION
The MCDrawBadge function can be useful in circumstances where you are using a movie controller component but do not want to incur the overhead of having the QuickTime movie in memory all the time. This function allows you to display the badge without having to display the movie. In addition, you can use the badge region to perform mouse-down event testing.